Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / General Data Management

MediaSetMediaTimeScale

The MediaSetMediaTimeScale function allows the Movie Toolbox to inform your media handler that your media's time scale has been changed.

pascal ComponentResult MediaSetMediaTimeScale 
                                    (ComponentInstance ci,
                                     TimeScale newTimeScale);

ci

Identifies the Movie Toolbox's connection to your derived media handler.

newTimeScale

Specifies your media's new time scale.

DESCRIPTION

The Movie Toolbox calls your derived media handler's MediaSetMediaTimeScale function whenever your media's time scale is changed. Applications can change your media's time scale by using the Movie Toolbox's SetMediaTimeScale function. When the Movie Toolbox calls this function, your media handler should recalculate any time values you have stored that are expressed in your media's time coordinate system. Changing your media's time scale may also affect media playback.

You obtain the initial media time scale information from the mediaScale field of the movie parameter structure that the Movie Toolbox provides to your MediaInitialize function.

Your derived media handler should support this function if your media handler stores time information that pertains to its media.

RESULT CODES

Any Component Manager result code